Removes a task exception.

OSStatus MPDisposeTaskException (
    MPTaskID task, 
    OptionBits action
);

task

The task whose exception you want to remove.

action

Any actions to perform on the task. For example, you can enable single-stepping when the task resumes, or you can pass the exception on to another handler. See “Task Exception Disposal Constants” for a listing of possible values.

function result

A result code. If the specified action is invalid or unsupported, or if the specified task is not suspended, this function returns kMPInsufficientResourcesErr.

DISCUSSION

This function removes the task exception and allows the task to resume operation. If desired, you can enable single-stepping or branch-stepping, or propagate the exception instead.

VERSION NOTES

Introduced with Multiprocessing Services 2.0.

AVAILABILITY

Supported in Carbon. Available in CarbonLib 1.0 and later when MPLibrary 2.0 or later is installed. Exported by CarbonLib 1.0 and later and by MPLibrary 2.0 and later.

© 2000 Apple Computer, Inc. — (Last Updated 4/6/2000)